Skip to content

docs: adding repo level claude.md - #149

Merged
rmad17 merged 5 commits into
mainfrom
docs/claude-md
Aug 13, 2026
Merged

docs: adding repo level claude.md#149
rmad17 merged 5 commits into
mainfrom
docs/claude-md

Conversation

@rmad17

@rmad17 rmad17 commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Added

  • doc: Added CLAUDE.md as the single source of truth for AI-agent guidance, including persona, working principles, project structure, repo boundaries, and security considerations
  • doc: Added AGENTS.md to import CLAUDE.md so Claude Code, Codex CLI, Gemini CLI, and other compatible tools load the repo conventions
  • doc: Added references/ docs for code style, testing, commands, pitfalls, git workflow, and docs-update guidance

Changed

  • doc: Centralized AI-agent instructions around tracked references/ files instead of untracked docs/ output
  • doc: Documented always-do, ask-first, and never-do boundaries to reduce incorrect agent assumptions in this repo

@rmad17 rmad17 self-assigned this Aug 4, 2026
@rmad17
rmad17 requested a review from a team as a code owner August 4, 2026 07:02
@rmad17
rmad17 requested a review from kishore7snehil August 7, 2026 12:13
Comment thread CLAUDE.md Outdated
Comment thread references/pitfalls.md
Comment thread CLAUDE.md
Comment thread references/docs-update.md
rmad17 added 3 commits August 11, 2026 12:27
- Treat an existing *ErrorCode constant as public API in Ask First
- Replace drifting transcribed values (format-clean count, Poetry pin,
  Python matrix) with the reasoning plus a pointer to the config/command
- Add a rule for creating an examples/ guide when a feature has none
- Add references/flow-map.md so every flow has an entry-point pointer,
  not just MCD
Comment thread references/docs-update.md
Comment thread references/git-workflow.md
Comment thread references/git-workflow.md

@kishore7snehil kishore7snehil left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@rmad17
rmad17 merged commit a369bf1 into main Aug 13, 2026
9 checks passed
@rmad17
rmad17 deleted the docs/claude-md branch August 13, 2026 11:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants